SEMINAR QULINE FOR THE O.S 


A. Overview of the O.S. 

1* Elements of the O.S. 

a. ROM-Based Character Set. 

b. System Data Base 

c. A set of Vectors to System Routines 

d. I/O Subsystem Structure 
1, I/O Control Blocks 

■ 2. I/O System Routines 

e. Interrupt Handlers 

1. Non-Maskable Interrupts (NMI's) 

2. Maskable Interrupts (IRQ's) 

f. Monitor 
< 3 . Timers 

h. I/O Hardware Registers 
i . Program RAM 
j. Floating Point Package 
k♦ Cartridges 

B. I/O Subsystem Structure 

1. I/O Control Blocks 

a. lOCB's 

b. ZIOCB 

c. DCB 

2. I/O System Routines 

a. CIO 

1. Calling Convention 

2. Handler Address Table(HATABS) 

3. Handler Entry Point Tables 

b. Device Handlers 

1. Resident Handlers 


a)« 

Display Editor 

(E.) 

b) ♦ 

Screen Handler 

(St) 

c) ♦ 

Keyboard 

<k: ) 

d). 

Printer 

(p: ) 

e). 

Cassette 

(Cl) 


2. Resident Disk Handler 

3. Non-Resident Handlers 

a) . DOS 

b) . RS-232 Handler (850) 

c) . User-added Handlers 

c. SIO 

1. Calling Convention 

C. Monitor 

1. Called 

a. Power-up (Coldstart) 

1. Power-cycled 

2. Coldstart Vector (E477) 

3. SYSTEM RESET If COLDSTOO 

b. SYSTEM RESET (Warmstart) 

1. SYSTEM RESET Key 

2. Warmstart Vector (E^7^) 

2. Points of Interest 

a. A Warmstart Changes 
1. MEMLO 



2. Handler Address Table <HATAE:S> 

3♦ IRQ Vector Table 

b. JSR (CASINI) if BOOT? set 

c. JSR (DOSINI) if BOOT? set 
e. Using DOSINI to fix a above 

D. Program RAM 

1. Memory Map 

a. MEMLO 

b. MEMTOP 

c. APPMHI 

d. RAMTOP 

E. Interrupt Handlers 
1* NMI's 

a. SYSTEM RESET - Non-Maskable 

b. DLI 

1. VDSLST - Display List Vector 
. c. VBLANK 

1* Immediate (Stage 1) 

a. VVBLKI - Vector 

b. Critical Sections 

1) , SEI 

2) * CRITiC 
c . Stage 2 

1) ♦ Shadows 
2* Deffered 

a♦ VVBLKD - normally points to RTI 

2. IRQ's - 

a♦ One Bit Mask (SEI/CLI) 

b. IRQEN and POKMSK 

c. The IRQ's Vectors and Their uses 

1. VMIRQ - system IRQ Vector 

2. VBREAK - Software BRK instr. 

3* VKEYBD - Key board interrupt 

4. VSERIN - Serial Bus Input Ready 
5* VSEROR - Serial Bus Output Ready 
6. VSEROC - Serial Bus Comp late 
7♦ VTIMR1 - Pokey Timer 1 
8. VTIMR2 - Pokey Timer 2 
9* VTIMR'? - Pokey Timer 4 

10. CDTMA1 - System Timer 1 

11. CDTMA2 - System Timer 

F. Timers 

1. Real-Time Clock (RTCLOK) 
a. 3- byte Frame Counter 

2. System Timers 

a. CDTMV1 - CDTMA1 

b. CDTMV2 - CDTMA2 

c. CDTMV3 - CDTMF3 

d. CDTMV4 - CDTMF4 

e. CDTMV5 - CDTMA5 




POWER-UP 


NO (MIDDLE 
OF COLDSTART) 


C0LDST=0 



CLEAR O.S. RAM 
($2QO-3FF,$10-7F) 


FIND # OF 4K BLOCKS 
OF RAM (TRAMSZ) 
INITIALIZE POKEY, ANTIC, 
CTIA/GTIA 


WARMST=0 


YES(POWERUP) 


CLEAR ALL RAM 
($08-TRAMSZ) 

SET DEFAULT CARTRIDGE TO j 

BLACKBOARD (DOSVEC=BLKBDV) i 

SET COLDST TO MIDDLE OF POWER-UP i 
(COLDST=$FF) 


SET SCREEN MARGINS 
(LMARGN=2 
RMARGN=39) 


MOVE IRQ VECTOR TABLE 
FROM ROM TO RAM 
(VDSLST-VVBLKD) 



- 1 - 














ENABLE IRQ INTERRUPTS; 



CLEAR B CART. SET B CARTRIDGE 

FLAG(TSDAT=0) i FLAG(TSDAT-l) 















PAGE 2 


/ A \ 

YES 

INITIALIZE 

CARTRIDGE >— 


—>A CARTRIDGE 



i(OSR($BFFE)) 



CLEAR A CART. 
FLAG (TRAM5Z=0) 
(JSR($BFFE)) 


SET A CART. 
FLAG(TRAHSZrl) 


OPEN EDITOR 


ERROR ON 
vOPEN E:> 


POWER-UP 


I WAIT FOR VBLANK 
TO SET UP SCREEN 


DO CASSETTE 
BOOT 


YES (RESET) 


s WARHSTs$FF^x > - 

\. NO(POWERUP) 


CKEY=1 

, 9 


Cassette 

boot 

-QKAY?/ 


YES run program 

- y booted 

Ctsr(casini)) 


PRINT 'BOOT ERROR' ! 
ON SCREEN i 


B00T?=2 
















The byte of "00" is used to allow the OS to determine when a cartridge! 
is inserted; locations BFFC and 9FFC will not read zero when there is 
neither RAM at those locations nor a cartridge inserted. RAM is 
differentiated from a cartridge tiy its ability to be altered. 

The option byte has the following option bits: | 

” i 

Bit-0 = 0» then do not boot the disk. j 

( 1» then boot the disk. j 

• i 

& Bit—2 = 0» then init but do not start the cartridge. 

1# then init and start the cartridge. 

Bit-7 = 0, then cartridge is not a diagnostic cartridge. 

1/ then cartridge is a diagnostic cartridge & control 
will be given to the cartridge before any of the OS 
is initialized (JMP (BFFE) >. 
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\-AMbLGZ. 


£43 0 


• PRINTV 

= 

$ E 4 3 0 




E440 


CASETV 

= 

$E440 

.. 



E40 0 


EDITRV 

= 

$E40 0 




£410 


SCRENV 

= 

$E4;10 




E420 


KEYBDV 

♦ 

= 

$E420 




0000 


t 

♦ 

sc= $031A 






HATABS 


■ 




031A 

50 


♦ BYTE 

'1_ 




031B 

30E4 


♦ WORD 

PRINTV j 




031D 

43 


♦ BYTE 

' C 




031E 

40E4 


♦ WORD 

CASETV 




0320 

45 


♦ BYTE 

' E 




0321 

0 0E4 


♦ WORD 

EDITRV 




0323 

53 


♦ BYTE 

' s ' 




0324 

1 0E4 


♦ WORD 

SCRENV 




0326 

4B 


♦ BYTE 

'K 




0327 

20E4 


♦ WORD 

KEYBDV 




032? 

o-o 

. 

♦ BYTE 

0 




032A 

06 


♦ BYTE 

0,0 




032B 

0 0 







032C 

00 


♦ BYTE 

0 




032D 

OO 


♦ BYTE 

0,0 




032E 

00 







032F 

00 


♦ BYTE 

0 




0330 

0 0 


♦ BYTE 

0,0 




0331 

00 







0332 

00 


♦ BYTE 

0 




0333 

00 


♦ BYTE 

0,0 




0334 

00 







0335 

00 


♦ BYTE 

0 




0336 

00 


♦ BYTE 

0,0 




0337 

OO 







0333 

00 


♦ BYTE 

0 




0339 

00 


♦ BYTE 

0,0 




033A 

0 0“ 







Q33E: 

OO 


♦ BYTE 

0 




Q33C 

00 


♦ BYTE 

0,0 




033D 

OO 




• 

A ' 





-- 

. - 

» PRINTER 

HANDLER ENTRY 

►QINTS 





1 

*-*E430 

<- 

_j 

! 



E430 9E EE 


1 

: WORD 

PHOPEN-l 


PRINTER HANDLER 



E432 OB EE 


. WORD 

PHCLOS-1 


PH CLOSE 



E434 90 EE 


. WORD 

3ADST—1 

PH 

READ 



E436 A6 EE 


.WORD 

PHWRIT—1 


PH WRITE 



E438 80 EE 


. WORD 

PMSTAT-1 


PH STATUS 



E43A 90 EE 


. WORD 

DADST-i 

PH 

SPECIAL 



E42C 4C 78 

EE 

Ji-P 

ph:nit 


PH INIT. 



E42F OO 


. 3YTE 

0 


ROM FILLER 




I 10 Si/'W'jsie rv "v S4Tvc.Ty>rC» 


pu- periphetavs 
exce pr Kesteewr 
t>iSL HANtx-erCS 


Res/dewt 

Di s< 

handier 


\)S£-g. 


PF.06Am 


Clo CALL. . 


\OCS 


XSR Alov 
JBtnX ee.s.oK 
BPl G-OoD 


CEVreftL. 

x/o Routw 

(CIO) 


CftLL TO 

de^vae bawdier.: ose hwdccc naoeess 
T*ei£ CHATAas') TP 
fioa oevtce i+MiUct. 
entry pot MTS 



Ziocq 


DEVICE 

Mamdler 


fx 

v nv!;\. 

- -4- N ^ 


OSEK. PROfeM** 

(DOS 'or— 


serial ays PEKvPnetw- 
Only 


XSR 4J0V 

SfM eeeoe. 

RTS 


DiSl havdlEC CHu. : 


Sit DSKICV 

81*11 £/e*os 


SEptAu 

X/O (ZoyTtME 

C sxo) 


R£S» DEUT 

P\SLPAWOL£< 


SIO CfitL 1 TSfJ SIOV 

gm» £*£0K 
RTS 


S£<'AL> DATA 
T^msfcr 
via pokr't f»Jt> 
th<t scc\al e^s 












10 ,* WRITTEN BY. . . MICHAEL EKE:ERG 
20 \ 


30 START .= $600 

40 DOSINI = $0C 

50 MEMLO = $2E7 

60 NEWMEM = <$3000 ALTER THIS TO GET SIZE 

70 i THIS ROUTINE RESERVES SPACE FOR 

80 } ASSEMBLY ROUTINES BY RESETTING 

90 J THE MEMLO POINTER♦ IT RUNS AS 

0100 ; AN AUTORUN♦SYS FILE* IT ALSO 

0110 \ RESETS HEMLO ON CRESETI♦ MEMLO 

0120 ; IS SET TO THE VALUE OF NEWMEM* 


80 } ASSEMBI 
90 l THE ME1 
'0100 ; AN Al 
0110 } RESE 
0120 ; IS SI 
0130 \ 

0140 * THIS Pi 
0150 } TO B 
0160 \ HAS 
0170 i THE 
0180 ; DOS 
0190 } INIT 
0200 

0210 INITDOS 


THIS PART IS PERMANENT, IE* NEEDS 

TO BE RESIDENT. THE SYSTEM DOS INIT VECTOR 
HAS BEEN STOLEN, AND STORED IN 
THE LOCATION INITD0S+1&2. 

DOS IS INITIALIZED AND MEMLO IS INITIALIZED 
INITDOS EXECUTES ON CRESET3♦ 

*= START 


1600 

1603 

1605 

1608 

I60A 

)60D 


200D06 0220 

A90 0-- 0230- 

BDE702 >240 
A930 0250 - 

QDE802 0260 

0270 ENDRTS 
60 0280 

• 0290 *, THIS 

0300 J UP 

0310 } AF 

0320 ; THIS 

0330 ; CO 

0340 ; AT 

0350 J TH 


ENDRTS - JDO DOS INITLIST 

4NEWMEM & 255 

MEMLO 

$NEWMEM/256 

MEMLO+L 


RTS 

THIS PART IS EXECUTED AT POWER 
UP ONLY AND CAN BE DELETED 
AFTER POWER-UP. 

THIS ROUTINE STORES THE 

CONTENTS OF DOSINI INTO A JSR 
AT LOCATION INITDOS+1. IT 
THEN REPLACES DOSINI WITH 


0360 


IT'S OWN VALUE, THE LOCATION 




0370 ; 

INITDOS 

♦ 





0380 BEGIN 




360E 

A50C 

0390 

LDA 

DOSINI 

SAVE 

DOSINI 

3610 

8D0106 

0400 

STA 

INITDOS+1 


A 

3613 

A50D 

0410 

LDA 

DOSINI+1 



3615 

8D0206 

0420 

STA 

INITDOS+2 



3618 

A900 

0430 

LDA 

♦INITDOS&255 

SET 

DOSINI 

361A 

850C 

0440 

STA 

DOSINI 



361C 

A906 

0450 

LDA 

♦INITDOS/256 



361E 

850D 

0460 

STA 

DOSINI+1 



0620 

A900 

0470 

LDA 

♦NEWMEM&255 

SET 

MEMLO 

0622 

8DE702 

0480 

STA 

MEMLO 



0625 

A930 

0490 

LDA 

♦NEWMEM/256 



0627 

SDE802 

0500 

STA 

MEMLO+1 



062A 

60 

0510 

RTS 





062B 0520 *= $2E2 

02E2 0E06 0530 .WORD BEGIN SET RUN ADDRESS 

-m -a ni=;4n .end 




